spruce 


Download Spruce here: https://github.com/tenlevels/spruce 
Installation, Updating and Basic Setup Guide 
By SundownerSport 


Welcome to the wonderful new world of spruce, the SD card overhaul for the Miyoo A30 by tenlevels. 
This guide will be a brief overview guiding you through your first steps. It will get you up and running on the 
four most common operating systems. 

I am writing this as somebody that struggles with overly technical how-to guides. I have watched too 
many videos that just gloss over some very important steps that creates headaches for beginners like myself. 
Most importantly I am writing this as somebody that is new to retro-handhelds, for people that are new to them 
as well. 

The Basics: 

Spruce is not an operating system (OS), it is a modified version of the stock Miyoo OS that cleans up 
bloat, optimizes performance, focuses on aesthetics and ease of use. It is intended to be sleek, intuitive and 
efficient. Spruce is installed in the same way as OnionUI so if you have done that this will be a very straight 
forward procedure. 


You will need: 
1. Anew, branded microSD card, purchased from a reputable source. Like with the Miyoo Mini+, a 128GB 
card will be more than enough. 
We HIGHLY recommend Samsung Evo Select. 
2. Ahigh quality branded microSD card reader. 
3. Download and install Rufus on Windows. Tenlevels actually uses AOMEI Partition Assistant instead but 
Rufus is super simple, popular and effective. Here is a link to download Rufus. 


At the end of this guide I will give a brief overview of how, and where, to put your BIOS 
and ROMS file. 
Additional: I have added instructions on how to update to the latest spruce release without 


having to wipe the microSD card. This will save time by allowing you to keep your BIOS, 
Saves and ROMS folders. 


Spruce Installation Instructions: 


After an installation or update, power on the A30, refresh roms, and power it off and on again. 


Windows (10): 
Formatting your microSD card: 


1. Insert your microSD card into your computer. 

2. Open Rufus. 

3. Select your card from the top most drop down menu. 

4. Change “Boot selection” to “Non bootable”. 

5. Change “File system” to FAT32. 

6. If you want, name the drive in “Volume label”. 

7. Press Start, there will be a pop-up warning you that all data will be lost, press OK. 


Installation: 
1. In File Explorer, navigate to the downloaded “spruce.vX.X.zip” file. 
2. Right-click it, select “Extract all...” and extract the contents directly onto your microSD card. 
3. When this is complete, right click on the microSD card and select “Eject” to safely remove it. 
4. Insert the microSD card into the device and turn it on. 


Mace: 
Formatting your microSD card: 
1. Insert your microSD card into your Mac. 
2. Open Disk Utility. 
3. Select your microSD card. 
4. At the top of the window, click Erase. 
5. Name the card. 
6. Under Format select MS-DOS (FAT) and Master Boot Record for Scheme. 
7. Click Erase. 
8. When finished, click Done 
Installation: 
1. Open Finder. 
SHIOW HIDDEN FILES by pressing Command + Shift + . (Period). 
Navigate to the “spruce.vX.X.zip” and extract it. 
Copy/Paste the entire extracted contents onto your microSD card. 
Use an App like CleanEject (https://www.javawa.nl/cleaneject_en.html) to eject and clean the junk .dot 
files from your microSD card. 
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Chrome: 
Formatting your microSD card: 
1. Insert your microSD card into your computer. 
Open the “Files” app. 
Navigate to your microSD card. 
Right-click (double finger tap) on your card. 
Select “Format device”. 
Name the card. 
In “Format” select FAT32. 
Click “Erase and Format”. 
Click the Eject icon to the right of the drive name and remove the card. 
0. Reinsert the card (mine bugged out on me if I didn't do this and renamed all the files adding a “(1)” to 
the end). 
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Installation: 

In the “Files” app navigate to the downloaded “spruce.vX.X.X.zip” file. 
Open the file, this might take a second to load. 

Press Control+A to select all files. 

Right-click (double finger tap). 

Select “Copy”. 

Navigate to your microSD card (it will be blank). 

Right-click (double finger tap). 

Select “Paste”. 

When the files are done pasting, click on the Eject icon to the right of the drive name. 
0. Remove the microSD card and insert it into your A30. 
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Linux: 
There are just too many distros to get into a lot of detail with Linux. 


Format your microSD card to FAT32, I used the standard disk utility on Ubuntu. 
Extract the “spruce.vX.X.X” file. 
Open the extracted folder and SHOW HIDDEN FILES. 
Copy and Paste the contents of the extracted folder onto the microSD card. 
When complete, eject the microSD card and insert it into your A30. 

Linux Note: 
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Ubuntu, at least for me, has the .Config and .Temp Update folders hidden, you need these files. 


Your microSD Card Should Look Like This: 


DI config 
TO mp update 
DI App 

25 BIOs 

™ Emu 

PI Icons 

a miyoo 
S RetroArch 
© Roms 

DI Saves 

™ spruce 
© Themes 
=| autorun 
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The .config and .tmp_update folders are very important and without them spruce just isn't going 
to work properly. If you are having issues, please check to see that these folders are present on 
your microSD card. 


Updating to the Latest Release: 


This section will only cover Windows; this process will be very similar in other OS's. Updating will 
allow you to carry over any Save, ROM and BIOS files you have already written onto your microSD card vastly 
shortening the time required vs. a full fresh installation. This entire process will only take a few minutes. 

After an installation or update, power on the A30, refresh roms, and power it off and on again. 


1. Download the latest spruce release from the link at the beginning of this guide. 

2. Extract the “spruce.vX.XX” file onto your computer, not onto your microSD card. 

3. Insert your microSD card into your computer. 

4. Open 2 File Explorer windows; one showing your microSD card, one showing the files within the latest 
release. 

5. In the spruce microSD card, press CTRL+A to select all, CTRL+left-click on the “Roms”, “BIOS” and 
“Saves” folders to deselect them. 

6. Right-click the selected items and delete them. 

7. Drag and drop the entire contents of the latest spruce release onto the root of the microSD card. 

8. If prompted, allow the new files to replace the existing ones. 

9. After this has finished you can eject the microSD card from your computer an insert it into your device. 


Important Note: 
Mac and Linux have the .Config and .Temp Update files hidden. YOU MUST SHOW HIDDEN FILES. 
This will mess with the update and spruce will not work as it should. 


Where to put BIOS: 


> SPRUCE (R:) > BIOS 


The BIOS folder is located on the root of the microSD card. It is called “BIOS”. Place your BIOS files 
within the “BIOS” folder. 


Where to put ROMS: 


SPRUCE > Roms 


ROM files should be placed into their respective folders. For example N64 ROMS must be placed in the 
“N64” folder within the “Roms” folder. Below is a table with the names of systems and their folder name. 


System 

Amiga 

Amstrad CPC 

FBNEO 

Atari 2600 

Atari 5200 

Atari 7800 

Atari Lynx 

Bandai Sufami Turbo 
Bandai WonderSwan & Color 
Commodore 64 

Capcom Play System 1 
Capcom Play System 2 
Capcom Play System 3 
ColecoVision 

Fairchild Channel F 
Famicom Disk System 
Game & Watch 

GCE Vectrex 

Magnavox Odyssey 2 
Mattel Intellivision 

Mega Duck 

MS-DOS 

MSX - MSX2 

NEC SuperGrafx 

NEC TurboGrafx CD 
NEC TurboGrafx-16 
Nintendo DS 

Nintendo Entertainment System 
Nintendo Game Boy 
Nintendo Game Boy Advance 
Nintendo Game Boy Color 
Nintendo Pokemini 
Nintendo Satellaview 
Nintendo Super Game Boy 
Nintendo Super Nintendo 
Nintendo Virtual Boy 
PICO-8 “Fake 8” 

PICO-8 “Native” 

Ports collection 


Roms Folders 


Rom Folder 
AMIGA 

CPC 

ARCADE 
ATARI 

FIFTY TWOHUNDRED 
SEVENTY EIGHTHUNDRED 
LYNX 

SUFAMI 

WS 
COMMODORE 
CPSI 

CPS2 

CPS3 

COLECO 
FAIRCHILD 
FDS 

GW 

VECTREX 
ODYSSEY 
INTELLIVISION 
MEGADUCK 
DOS 

MSX 

SGFX 


POKE 
SATELLAVIEW 
SGB 

SFC 

VB 

PICO 

PICO8 

PORTS 


System Rom Folder 
ScummVM SCUMMVM 
Sega 32X THIRTYTWOX 
Sega CD SEGACD 

Sega Game Gear GG 

Sega Genesis MD 

Sega Master System MS 

Sega SG-1000 SEGASGONE 
Sinclair ZX Spectrum ZXS 

SNK NeoGeo NEOGEO 

SNK NeoGeo CD NEOCD 

SNK NeoGeo Pocket & Color NGP 

Sony Playstation PS 

TIC-80 TIC 
Commodore VIC-20 VIC20 
VideoPac VIDEOPAC 
Watara Supervision SUPERVISION 
Sega Dreamcast DC 

Doom DOOM 

SNES MSUI MSUI 

Sega Genesis MSU MSUMD 
Nintendo 64 N64 

Play Station Portable PSP 
Wolfenstein WOLF 

Sharp X68000 X68000 
FFPlay, Video Player FFPLAY 
MAME MAME2003PLUS 


Need More Help? 


Find us on Reddit at r/MiyooMini 
or 
DM me at u/sundownersport on Reddit or message me on Discord I am happy to help one on one solving many 
issues! 


